home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / menu tools / magicmenu1_29 / english / magicmenu.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  57KB  |  1,104 lines

  1. @database MagicMenuE.guide
  2. @width 77
  3. @Node Main "Magic Menu Manual"
  4.  **************************************************************************
  5.                              M A G I C   M E N U
  6.                                   V 1 . 2 9
  7.  **************************************************************************
  8.                        
  9.  1992 - 1993 Martin Kornd
  10.                          ***************************
  11.                          *                         *
  12.                          *   I M P O R T A N T !   *
  13.                          *                         *
  14.                          ***************************
  15.     MAKE SURE YOU READ THE @{" INSTALLATION-NOTES " link InstallNote} !!!
  16.     IF YOU STILL USE MAGIC MENU 1.21 OR OLDER, YOU SHOULD READ THE
  17.     @{" RELEASE HISTORY " link History} !
  18.                              C O N T E N T S
  19.                              ===============
  20.         1. Introduction
  21.                 @{" 1.1     Motivation              " Link Motivation}
  22.                 @{" 1.2     Features                " Link Features}
  23.                 @{" 1.3     System Requirements     " Link Requirements}
  24.         2. Installation
  25.                 @{" 2.1     From Workbench          " Link InstallWB}
  26.                 @{" 2.2     From CLI                " Link InstallCLI}
  27.                 @{" 2.3     IMPORTANT NOTES         " Link InstallNote}
  28.                 @{" 2.4     Quitting Magic Menu     " Link Removing}
  29.         3. Configuration
  30.                 @{" 3.1     General                 " Link ConfBasic}
  31.                 @{" 3.2     Pull Down Menus         " Link ConfPDBasic}
  32.                     @{" 3.2.1     STANDARD          " Link ConfStandard}
  33.                     @{" 3.2.2     PRESSONCE         " Link ConfPressOnce}
  34.                     @{" 3.2.3     SELECT            " Link ConfSelect}
  35.                     @{" 3.2.4     3D-Look           " Link Conf3D-Look}
  36.                     @{" 3.2.5     STANDARD-LOOK     " Link ConfStandard-Look}
  37.                 @{" 3.3     Pop Up Menus            " Link ConfPUBasic}
  38.                     @{" 3.3.1     STANDARD          " Link ConfStandard}
  39.                     @{" 3.3.2     PRESSONCE         " Link ConfPressOnce}
  40.                     @{" 3.3.3     SELECT            " Link ConfSelect}
  41.                     @{" 3.3.4     3D-Look           " Link Conf3D-Look}
  42.                     @{" 3.3.5     STANDARD-LOOK     " Link ConfStandard-Look}
  43.                     @{" 3.3.6     CENTER BOXES      " Link ConfCenter}
  44.                 @{" 3.4     Keyboard control        " Link ConfKCBasic}
  45.                     @{" 3.4.1     ENABLE            " Link ConfKCEnable}
  46.                     @{" 3.4.2     MOUSE TO BAR      " Link ConfMouseToBar}
  47.                     @{" 3.4.3     START SEQUENCE    " Link ConfKCStart}
  48.                  3.5     The other switches
  49.                     @{" 3.5.1     TYPE              " Link ConfType}
  50.                     @{" 3.5.2     MARK SUB MENUS    " Link ConfMarkSub}
  51.                     @{" 3.5.3     DOUBLE BORDERS    " Link ConfDBorder}
  52.                     @{" 3.5.4     MENU TIMEOUT      " Link ConfTimeout}
  53.                     @{" 3.5.5     HIDE              " Link ConfHide}
  54.                     @{" 3.5.6     SAVE              " Link ConfSave}
  55.                     @{" 3.5.7     QUIT              " Link ConfQuit}
  56.                  3.6     Tool Types
  57.                     @{" 3.6.1     SMARTPATCH        " Link ConfSmartPatch}
  58.                     @{" 3.6.2     CHECKWB           " Link ConfCheckWB}
  59.                     @{" 3.6.3     USELAYER          " Link ConfUseLayer}
  60.                     @{" 3.6.4     KC_RALTRCOMMAND   " Link ConfKCRAltRCommand}
  61.                     @{" 3.6.5     CX_PRIORITY       " Link ConfCXPrio}
  62.                     @{" 3.6.6     CX_POPUP          " Link ConfCXPopUp}
  63.                     @{" 3.6.7     CX_POPKEY         " Link ConfCXPopKey}
  64.                     @{" 3.6.8     DONOTWAIT         " Link ConfDontWait}
  65.                     @{" 3.6.9     TOOLPRI           " Link ConfToolPri}
  66.                     @{" 3.6.10    STARTPRI          " Link ConfStartPri}
  67.         4. Keyboard commands
  68.                 @{" 4.1     Hotkeys                 " Link Hotkeys}
  69.                  4.2     During Menu-selection
  70.                     @{" 4.2.1     In all modes      " Link CtrlKeys}
  71.                     @{" 3.6.2     Keyboardcontrol   " Link KCKeys}
  72.         5. Hints and troubleshooting
  73.                 @{" 5.1     Question & Answer       " Link Questions}
  74.                 @{" 5.2     Possible Problems       " Link Problems}
  75.                 @{" 5.3     Programmer's Information" Link Profi}
  76.         6. History
  77.                 @{" 6.1     Development             " Link History}
  78.                 @{" 6.2     Future Features         " Link Future}
  79.         7. Trailer
  80.                 @{" 7.1     Credits                 " Link Credits}
  81.                 @{" 7.2     Licence                 " Link Licence}
  82. @endnode
  83. @Node "Motivation"
  84.                                1.1 Motivation
  85.                                **************
  86. Developing  AmigaOS  2.0,  Commodore's  developers have re-worked the outer
  87. appearance of the Amiga's User Interface in an astonishing way.
  88. ... too bad they forgot Intuition's menus ...
  89. As  I wanted to flee from the dull menu life and the many programs that are
  90. available  did  not  satisfy  me,  I sat down at my keyboard and started to
  91. type...
  92. (Programming the Amiga means _lots_ of fun!)
  93. @endnode
  94. @node "Features"
  95.                                 1.2 Features
  96.                                 ************
  97. Magic Menu includes the following features:
  98.   o  All Intuition menus are replaced by Magic Menu.  Therefore, all programs
  99.      using standard menus will appear in the new outfit.
  100.   o  Magic Menu supports @{" Pull-Down-Menus " Link ConfPDBasic} as well as @{" Pop-Up-Menus " Link ConfPUBasic}.
  101.   o  Menus  are  either  displayed  using the @{" Standard Look " Link ConfStandard-Look},  or the modern
  102.      AmigaOS 2.0 style @{" 3D-Look " Link Conf3D-Look}
  103.   o  Menus  may  be  controlled exclusively using the @{" keyboard " Link ConfKCBasic},  there's no
  104.      need to grab the mouse anymore.
  105.   o  There are three different types of using the menus:
  106.      @{" Standard " Link ConfStandard}, @{" Press Once " Link ConfPressOnce} and @{" Select " Link ConfSelect}.
  107.   o  Magic  Menu  can  be @{" configured " Link ConfBasic} in different ways, you may for example
  108.      define handling and appearance of Pull-Down and Pop-Up menus seperately.
  109.   o  Magic Menu  remembers every menu's last selected item, displaying Pop-Up
  110.      menus  the  next time at a position allowing quick selection of the same
  111.      or neighboring items.
  112.   o  if  a menu is selected while the currently active screen is not visible,
  113.      the screen is popped to the front for the menu display.  After selecting
  114.      an item, it is returned to the back.
  115.   o  if there is no input in a configurable time (moving the mouse, keypress)
  116.      the menu selection is canceled, avoiding the machine to be blocked too
  117.      long.
  118.   and lots more...
  119. @endnode
  120. @Node "Requirements"
  121.                            1.3 System Requirements
  122.                            ***********************
  123. There  is  only  one  requirement for using Magic Menu:  you have to be using
  124. AmigaOS 2.04 (37.175) or higher.
  125. Magic  Menu  will  also work with Kickstart 3.0, it will even utilize special
  126. features of the new operating system.
  127. Additional libraries are not needed.
  128. If  you  are  still  using  Kickstart  1.3  or  older, all you can enjoy is a
  129. requester reminding you that your are STILL not up-to-date...
  130. @endnode
  131. @node "InstallWB"
  132.                        2.1 Installation from Workbench
  133.                        *******************************
  134. Magic  Menu  only consists of one single program.  The easiest way to install
  135. it is using the Workbench.
  136. To  install, just move the "MagicMenu"-icon to the "WBStartup"-drawer of your
  137. boot  partition.  That way Magic Menu is automatically started every time you
  138. boot your system.
  139. In  order  not  to  open  the  @{" configuration-window " Link ConfBasic}  every  time  you start
  140. MagicMenu,  you  should  set  the Tool Type CX_POPUP=NO in the WB information
  141. window  of  MagicMenu.  Check  your Amiga manual to learn how the information
  142. window works.
  143. MagicMenu's configuration is saved in the program icon.  You can change these
  144. settings  directly  using  the Info-function of the Workbench.  Anyway, using
  145. MagicMenu's configuration window is a lot easier to use.
  146. @endnode
  147. @Node "InstallCLI"
  148.                           2.2 Installation from CLI
  149.                           *************************
  150. MagicMenu  may  also  be  run  from  the CLI.  The settings will also be read
  151. directly  from  the  icon,  which  has to be copied together with the program
  152. file.
  153. MagicMenu  detaches  from  CLI  itself, you don't have to use RUN.  Executing
  154. MagicMenu a second time will display the @{" configuration-window " Link ConfBasic}.
  155. Command line parameters are not supported in the current version.
  156. @endnode
  157. @Node "InstallNote"
  158.                              2.3 IMPORTANT NOTES
  159.                              *******************
  160. MagicMenu  has  to patch some OS-routines.  This does not bring any problems,
  161. as long as no other program patches the same functions.
  162. It  may  happen  that  MagicMenu  can't  be removed from memory, when another
  163. program  installs itself.  MagicMenu will recognize this and will give out an
  164. appropriate message,
  165. To  avoid problems of this kind, you should use a program like "SaferPatches"
  166. from  Martin  Adrian  or  similar.   When  using  SaferPatches  together with
  167. MagicMenu,  make  sure  you  set  the  TOOL TYPE  option @{" SMARTPATCH " Link ConfSmartPatch} to NO.
  168. Otherwise, leave it set to YES.
  169. References:
  170.     @{" Known Problems of MagicMenu " Link Problems}
  171.     @{" Programmer Information " Link Profi}
  172. @endnode
  173. @Node "Removing"
  174.                            2.4 Quitting Magic Menu
  175.                            ***********************
  176. Magic Menu can be removed from the system in three different ways:
  177. - Selecting QUIT in the @{" configuration-window " Link ConfBasic}
  178. - Using AmigaOS 2.x's "Exchange" program found in one of your system drawers
  179. - Sending a CTRL-C to the MagicMenu process.
  180. Please  note  that  it  might happen that MagicMenu can't be removed from the
  181. system at once.
  182. After  sending a message to another process, MagicMenu will wait for a reply.
  183. During  that time, MagicMenu will not finish.  After a certain time MagicMenu
  184. will get a timeout for this message and will exit anyway.
  185. A  lot  more difficult is the situation when a program that was started AFTER
  186. MagicMenu  patches the same system functions.  MagicMenu will notice that and
  187. display  a message.  Most of the time you can only select for MagicMenu to be
  188. disabled, it will then stay in memory but won't do anything anymore.  In some
  189. rare  cases  you  might want to select "Force uninstall".  Make sure you know
  190. what you  are doing,  because if  you don't, the systems  reliability will be
  191. affected. See also: @{" IMPORTANT NOTES " Link InstallNote} and the Tool Type @{" SMARTPATCH " Link ConfSmartPatch}.
  192. @endnode
  193. @Node "ConfBasic"
  194.                           3.1 General Configuration
  195.                           *************************
  196. MagicMenu  saves all setting as TOOL TYPES of its own icon. Of course you can
  197. change them there directly, some can only be changed by this way. But most of
  198. the settings can also be changed more comfortably by using the graphical user
  199. interface.
  200. To open the configuration window of MagicMenu, there are three possibilities:
  201. - execute the program a second time
  202. - using  the  program  "Exchange"  (to be found on your workbench disk in the
  203.   directory  Tools/Commodities):   Select  the MagicMenu entry and then "Show
  204.   Interface"
  205. - the easiest way is by using MagicMenu's @{" HotKey " Link ConfCXPopKey}.  If you didn't change it,
  206.   it's the combination of the three keys <CTRL>-<ALT>-<SPACE>.
  207. The window is divided into three areas:
  208. - Setup for @{" Pull-Down-Menus " Link ConfPDBase}
  209. - Setup for @{" Pop-Up-Menus " Link ConfPUBasic}
  210. - Setup for the @{" keyboard control " Link ConfKCBasic}
  211. - General switches, modifying MagicMenu's reactions in all modes.
  212. The  window  can  be  closed anytime using the Close-gadget in the upper left
  213. corner  or  by  selecting  the  button @{" HIDE " Link ConfHide}.  In both cases, MagicMenu will
  214. remain in memory and be active.
  215. To  save  the  current  configuration, just select @{" SAVE " Link ConfSave}.  All of the icon's
  216. Tool Types will be set to the current setup.
  217. To remove MagicMenu, select @{" QUIT " Link ConfQuit}.
  218. @endnode
  219. @Node "ConfPDBasic"
  220.                              3.2 Pull Down Menus
  221.                              *******************
  222. ... is  what  any  Amiga  user  is used to as standard menus.  A line of menu
  223. items in the top line of the menu, which open up when selected.
  224. The  pull-down  menus  of  MagicMenu  work  the same way, except that you can
  225. select between two different display types:
  226.     @{" Standard-Look " Link ConfStandard-Look}
  227.     @{" 3D-Look       " Link Conf3D-Look}
  228. Plus,   you  can  operate  the  menu  using  three  different  methods  (plus
  229. @{" keyboard control " Link ConvKCBasic}):
  230.     @{" Standard   " Link ConfStandard}
  231.     @{" Press Once " Link ConfPressOnce}
  232.     @{" Select     " Link ConfSelect}
  233. Which  of these methods or display types should be used is set using the left
  234. area of the @{" configuration window " Link ConvBasic}.
  235. @endnode
  236. @Node "ConfPUBasic"
  237.                               3.3 Pop Up Menus
  238.                               ****************
  239. You  might  need some time to get used to this option, But as soon as you do,
  240. you'll probably find it being a very comfortable way of selecting menu items.
  241. In  contrast to the normal @{" pull-down menus " Link ConfPDBasic} the menu is not displayed at the
  242. top  of  the  screen,  but  rather as a box at any place where your mouse is.
  243. You  do not need to move the mouse to the top of screen anymore.  Also, menus
  244. are not displayed horizontally, but vertically.
  245. Apart  from  that,  pop-up  menus  work just like the normal pull-down menus.
  246. They may be displayed using:
  247.     @{" Standard-Look " Link ConfStandard-Look} und
  248.     @{" 3D-Look       " Link Conf3D-Look}
  249. and are controlled in one of these modes:
  250.     @{" Standard   " Link ConfStandard}
  251.     @{" Press Once " Link ConfPressOnce}
  252.     @{" Select     " Link ConfSelect}
  253. Additionally,  there  is  an  extra  setting  called @{" CENTER BOXES " Link ConfCenter} that will
  254. probably make menu usage even easier.
  255. Which  of  these display kinds and selection methods are used by MagicMenu is
  256. defined using the center part of the @{" configuration window " Link ConvBasic}.
  257. @endnode
  258. @Node "ConfStandard"
  259.                     3.2.1 / 3.3.1 STANDARD menu selection
  260.                     *************************************
  261. Using the standard settings, MagicMenu will act just like the Amiga OS does:
  262. After  pressing  the  right mouse button, the menu strip (either pull-down or
  263. pop-up,  depending on the @{" menutype settings " Link ConfType} and the position of your mouse)
  264. will be displayed.
  265. The  menu  strip  will  only be displayed as long as you keep the menu button
  266. depressed.   Moving  the  mouse  pointer  to  a  menu  item  will display its
  267. subitems.
  268. To  select  a  particular  item,  move your mouse to it and release the right
  269. mouse button.
  270. To  select several menu items (without leaving the menu), you can - just like
  271. when  using  the  normal  Intuition  menus - press the left mouse button when
  272. pointing to an item.
  273. TOOL TYPE:
  274.     for @{" Pull-Down Menus " Link ConfPDBasic}: PD_BUTTONMODE=STANDARD
  275.     for @{" Pop-Up Menus    " Link ConfPUBasic}: PU_BUTTONMODE=STANDARD
  276. Other methods of menu selection:
  277.     @{" Press Once " Link ConfPressOnce}
  278.     @{" Select     " Link ConfSelect}
  279. @endnode
  280. @Node "ConfPressOnce"
  281.                    3.2.2 / 3.3.2 PRESS ONCE menu selection
  282.                    ***************************************
  283. This option will probably be most appreciated by owners of trackballs, though
  284. others  might also find it useful:  during menu selection, you do not have to
  285. keep the right mouse button pressed, a short click will suffice.
  286. After  that,  the  menu  strip  is  displayed  (either  pull-down  or pop-up,
  287. depending  on the @{" menutype settings " Link ConfType} and the position of your mouse) and you
  288. can   browse  through  the  different  menus  and  items  just  like  in  the
  289. @{" standard setting " Link ConfStandard}.
  290. To  select  an item, either the left or right mouse button has to be pressed.
  291. If  you  use  any  of  the buttons outside of the menu area, the selection is
  292. aborted.
  293. For multiple selects, use the left mouse button while holding the shift key.
  294. TOOL TYPE:
  295.     for @{" Pull-Down Menus " Link ConfPDBasic}: PD_BUTTONMODE=PRESSONCE
  296.     for @{" Pop-Up Menus    " Link ConfPUBasic}: PU_BUTTONMODE=PRESSONCE
  297. Other methods of menu selection:
  298.     @{" Standard " Link ConfStandard}
  299.     @{" Select   " Link ConfSelect}
  300. @endnode
  301. @Node "ConfSelect"
  302.                      3.2.3 / 3.3.3 SELECT menu selection
  303.                      ***********************************
  304. ... is the setting I prefer most. Especially for @{" Pop-Up menus " Link }.
  305. Just  as  with the @{" PressOnce " Link ConfPressOnce} setting, the right mouse button only has to be
  306. pressed  once  real short and the menu will be displayed (either as Pull-Down
  307. or Pop-Up menu, depending on the setting of the @{" menu type " Link ConfType}).
  308. In  contrast to the other mode, the menu items aren't activated by moving the
  309. mouse  over  them, they have to be selected using the left mouse button, too.
  310. The  same  applies to subitems:  to display them, their parent item has to be
  311. selected.
  312. The  main  advantage  of  this  setting  is  that  menus  won't  be displayed
  313. accidently  by  moving  the  mouse  a pixel too far.  Some programs have very
  314. complex  menus,  which  almost  cost  some nerves finding a menu item.  Using
  315. SELECT you can use it like a switch box.
  316. Selecting  an  item  that  has  no  subitems attached will return this item's
  317. number  to the appropriate program.  To do a multiple select, press the shift
  318. key while selecting an item.
  319. TOOL TYPE:
  320.     for @{" Pull-Down Menus " Link ConfPDBasic}: PD_BUTTONMODE=SELECT
  321.     for @{" Pop-Up Menus    " Link ConfPUBasic}: PU_BUTTONMODE=SELECT
  322. Other methods of menu selection:
  323.     @{" Standard   " Link ConfStandard}
  324.     @{" Press Once " Link ConfPressOnce}
  325. @endnode
  326. @Node "Conf3D-Look"
  327.                         3.2.4 / 3.3.4 3D-Look Display
  328.                         *****************************
  329. As  of  version 2.0 of the AmigaOS, Commodore has introduced a new 3D-Look in
  330. the  display  of  the  user interface.  MagicMenu implements this with menus.
  331. This not only makes the menus look better, but usually also easier to use.
  332. Additionally,  there  are  two  functional  differences  resulting  from this
  333. change:
  334. - Intuition  will  only  visibly  select  a  menu item, if it is not disabled
  335.   (displayed as ghosted entry).  MagicMenu implements a similar behavior, but
  336.   disabled  items  will  have  a  kind  of `ghosted frame',  mainly  to  make
  337.   @{" keyboard usage " Link ConfKBasic} easier.
  338. - Apart  from  menu  items that directly result in some operation, there also
  339.   some  that turn an option on or off. These items are displayed with a small
  340.   check  mark  when the option is turned on. Of course does MagicMenu support
  341.   these,  though  the  display has been polished up a bit. But there are also
  342.   other  menu  items  that have a check mark even though they react different
  343.   than the other items: mutually exclusive menu items. This could be used for
  344.   a  color  selection,  where only one color can be used at a time. MagicMenu
  345.   will  display  these  just like OS 2.0's user interface does: it uses radio
  346.   buttons  that  either  look  recessed or raised,  depending  on whether the
  347.   item  is  selected  or  not. This way, these menu options can be recognized
  348.   easier as mutualy exclusive items.
  349. In  order to be able to have the 3D-Look, the screen displaying the data must
  350. have  been  opened  with  at least 4 colors in a 2.0-compatible manner.  This
  351. might not be true for some older programs written for 1.3 or earlier.
  352. Anyway,  there  are programs (like TagScreens from Martin Berndt) that modify
  353. opened screens, so that they do get the 3D-Look.  As sometime the colors will
  354. not  fit  right  anymore,  MagicMenu's menus might not look three-dimensional
  355. anymore.  In such cases using the @{" standard look " Link ConfStandard-Look} might be preferable.
  356. To  switch  between  standard  and 3D-Look, you can always press the Ctrl-key
  357. while displaying a menu.
  358. A  few  programs,  mainly  some that use menus for color selections, will not
  359. work correctly with MagicMenu, check the @{" problems " Link Problems} section ...
  360. TOOL TYPE:
  361.     for @{" Pull-Down Menus " Link ConfPDBasic}: PD_LOOK=3D
  362.     for @{" Pop-Up Menus    " Link ConfPUBasic}: PU_LOOK=3D
  363. @endnode
  364. @Node "ConfStandard-Look"
  365.                      3.2.5 / 3.3.5 STANDARD-LOOK Display
  366.                      ***********************************
  367. If  you should not want the _three dimensional display_ of the menus, you may
  368. always  switch back  to  the  old display style, while still enjoying all the
  369. additional  features  of  MagicMenu.  While carefully implementing all of the
  370. original flavor, there is only one slight difference to Intuition's menus:
  371. When   using  the  keyboard  to  control  the  menus,  "disabled"  items  are
  372. highlighted,  too.  This was necessary as doing without would make it hard to
  373. find out where you actually are.
  374. If  a screen only has 2 colors, or has been opened using pre-2.0-methods, the
  375. standard look display is used automatically.
  376. TOOL TYPE:
  377.     for @{" Pull-Down Menus " Link ConfPDBasic}: PD_LOOK=2D
  378.     for @{" Pop-Up Menus    " Link ConfPUBasic}: PU_LOOK=2D
  379. @endnode
  380. @Node "ConfCenter"
  381.                             3.3.6 CENTER BOXES
  382.                             ******************
  383. This  setting  is only used with @{" pop-up menus " Link ConfPUBasic}, it doesn't affect the normal
  384. @{" pull-down menus " Link ConfPDBasic}.
  385. If subitems are attached to an item, they will usually be displayed downwards
  386. and  to  either  the left or right side of the item; the programmer will have
  387. taken care of placing the submenu (or GadTools for newer applications).
  388. Using  the  setting CENTER BOXES, you instruct MagicMenu to forget about that
  389. positioning and instead find a more efficient place for the submenu:
  390. If  no  menu  item  has  been selected before, the submenu will be vertically
  391. centered  relative to the menu item.  Here's a little graphical demonstration
  392. of that process:
  393.        Without CENTER BOXES:
  394.                           ---------
  395.                          | Project |
  396.                          |         |
  397.                          | Edit    |
  398.                          | ------- -----------
  399.                          ||Options| Tabs      |
  400.                          | -------|           |
  401.                          | Texts  | Pathes    |
  402.                           --------|           |
  403.                                   | Colors    |
  404.                                   | -------- ----
  405.                                   ||Height  | 10 |
  406.                                   | --------|    |
  407.                                   | Width   | 12 |
  408.                                   |         |    |
  409.                                   | Depth   | 15 |
  410.                                    --------- ----
  411.        With CENTER BOXES:
  412.                                    -----------
  413.                           --------| Tabs      |
  414.                          | Project|           |
  415.                          |        | Pathes    |
  416.                          | Edit   |          ----
  417.                          | -------| Colors  | 10 |
  418.                          ||Options| --------|    |
  419.                          | -------||Height  | 12 |
  420.                          | Texts  | --------|    |
  421.                           --------| Width   | 15 |
  422.                                   |          ----
  423.                                   | Depth     |
  424.                                    -----------
  425. When an item had been selected before, this item will be put directly beside
  426. it's preceding item, e.g. after selecting `Width' in the above menu, it would
  427. be opened like this the next time:
  428.                                    -----------
  429.                                   | Tabs      |
  430.                                   |           |
  431.                                   | Pathes    |
  432.                           --------|           |
  433.                          | Project| Colors    |
  434.                          |        |           |
  435.                          | Edit   | Height    |
  436.                          | -------| --------- |
  437.                          ||Options||Width    ||
  438.                          | -------| --------- |
  439.                          | Texts  | Depth     |
  440.                           -------- -----------
  441. This way, selecting an item will be a lot easier the next time.
  442. TOOL TYPE:
  443.     for @{" Pop-Up Menus " Link ConfPUBasic}: PU_CENTER=YES or PU_CENTER=NO
  444. @endnode
  445. @Node "ConfKCBasic"
  446.                             3.4 Keyboard Control
  447.                             ********************
  448. One  of  the  big  advantages of MagicMenu is that you might as well put your
  449. mouse  aside, as menus can be used completely without mouse interaction, even
  450. if it does not have a shortcut sequence (Amiga-key + another key).
  451. If  the  menu  is  selected using the keyboard (either with the RIGHT ALT and
  452. RIGHT AMIGA keys or with  the combination set via @{" START SEQUENCE " Link ConfKCStart}), the menu
  453. strip  will  be  displayed  at  the top border.  (With keyboard control, only
  454. @{" pull-down menus " Link ConfPDBasic} are used)
  455. When  first displaying a menu, one of the menus is selected. If no other menu
  456. choice  was  done before, it will be the left-most menu, otherwise the one of
  457. which  an  item  was  selected.   Use the cursor keys to select the different
  458. menus.   Pressing  Return  selects a menu and displays it's menu items.  With
  459. items,  either the submenus are displayed, or the current item is selected if
  460. there  are  none.   The ESCape key lets you go up one level or leave the menu
  461. selection without selecting an item.
  462. The  easiest  way  to select a menu or item is to press the first letter of a
  463. selection.   If  there is only one menu or item that fits to that letter, the
  464. appropriate  menu  or item is selected, otherwise the cursor is only moved to
  465. that  item.  In that case, pressing the letter again will let MagicMenu cycle
  466. through the possible selections.  Press the Return key to select the item.
  467. For multiple selection, press the Return key together with the shift key. The
  468. menu  selection  can  be  aborted  anytime using the activation sequence (see
  469. above).
  470. As  you  may  have  noticed, MagicMenu tries to take a good guess at what you
  471. want to do and remembers all the levels of the last selection.
  472. There are the following settings available for keyboard control:
  473.     @{" ENABLE         " Link ConfKCEnable}
  474.     @{" MOUSE TO BAR   " Link ConfMouseToBar}
  475.     @{" START SEQUENCE " Link ConfKCStart}
  476. These settings are located at the right area of the @{" configuration window " Link ConfBasic}.
  477. There  are  further  descriptions  of  the  keyboard sequences in the chapter
  478. @{" keyboard layout " Link CtrlKeys}.
  479. @endnode
  480. @Node "ConfKCEnable"
  481.                        3.4.1 ENABLE (Keyboard control)
  482.                        *******************************
  483. If  this  option  is  turned  on,  the  menus  can be controlled via keyboard
  484. commands.
  485. For further information check the following chapters:
  486.     @{" Keyboard control " Link ConfKCBasic}
  487.     @{" Keyboard layout " Link CtrlKeys}
  488. @endnode
  489. @Node "ConfMouseToBar"
  490.                              3.4.2 MOUSE TO BAR
  491.                              ******************
  492. Some  programs (like DPaint or Directory Opus) only allow menu selection when
  493. the  mouse  is  somewhere in the menu strip of the screen, as the right mouse
  494. button has another meaning at other areas.
  495. As this would make menu selection via keyboard controls impossible, MagicMenu
  496. will  move  the  mouse  to the top line when this option is turned on and the
  497. @{" start sequence " Link ConfKCStart} is deteced.
  498. For further information, check the chapter @{" Programmer's Information " Link Profi}.
  499. @endnode
  500. @Node "ConfKCStart"
  501.                             3.4.3 START SEQUENCE
  502.                             ********************
  503. This input field allows you to select the key combination which activates the
  504. @{" keyboard-controlled menu selection " Link ConfKCBasic}.
  505. All  key  names recognized by any other commodity may be used, see your Amiga
  506. manual for further information on commodities. For your information, here's a
  507. list  of  the  names known to the Amiga OS Version 2.04. (Later versions know
  508. some more)
  509.     lshift                  space
  510.     rshift                  backspace
  511.     capslock                tab
  512.     control                 enter
  513.     lalt                    return
  514.     ralt                    esc
  515.     lcommand                del
  516.     rcommand                up
  517.     numericpad              down
  518.     shift                   right
  519.     alt                     left
  520.     caps                    f1 - f10
  521.                             help
  522. For  example,  using  "lcommand space" means that pressing the left Amiga-key
  523. and the space key together will bring up the menu.
  524. Entering  an  incorrect  combination  will  result  in  an error message from
  525. MagicMenu, the old setting will remain active.
  526. The  combination  "ralt  rcommand"  (the right Alt and Amiga key) will always
  527. work,  independent  of  the start sequence entered (except if @{" ENABLE " Link ConfKCEnable} is not
  528. selected).
  529. @endnode
  530. @Node "ConfType"
  531.                        3.5.1 TYPE (large Cycle Gadget)
  532.                        *******************************
  533. Use this switch between the different available menu types.
  534.     USE PULL DOWN MENU ONLY
  535.         If this mode is selected, only @{" Pull-Down menus " Link ConfPDBasic} will be used.
  536.     USE POP UP MENU ONLY
  537.         This  mode will result in only _Pop-Up menus_ being used, even if the
  538.         mouse  is  in  the  title  bar  of  the  screen.  Anyway, there is an
  539.         exception:  for keyboard control, Pull-Down menus are used.
  540.     USE PULL DOWN WHEN POINTER IN MENUBAR, POP UP OTHERWISE:
  541.         The  "automatic mode".  When the mouse is somewhere in the title bar,
  542.         Pull-Down  menus  are used, otherwise Pop-Up menus.  This  might come
  543.         handy  for  people  being  used  to moving the mouse to the title bar
  544.         before  pressing  the  right mouse button.  Heart attacks and similar
  545.         won't probably take place due to unexpected menu appearance.
  546. TOOL TYPE:
  547.     for "USE PULL DOWN MENU ONLY":         MENUTYPE=PULLDOWN
  548.     for "USE POP UP MENU ONLY":            MENUTYPE=POPUP
  549.     for "USE PULL DOWN WHEN POINTER ...":  MENUTYPE=AUTO
  550. @endnode
  551. @Node "ConfMarkSub"
  552.                            3.5.2 MARK SUB MENUS
  553.                            ********************
  554. This  option  enables the marking of menu items that have a submenu attached.
  555. When turned on, a small arrow will appear at the right side of such items.
  556. If  the  text  of  this item is too long or if the program uses its own marks
  557. (e.g.   when  using  GadTools  to  layout  the  menus),  MagicMenu's arrow is
  558. disabled.
  559. TOOL TYPE:
  560.     MARKSUB=YES or MARKSUB=NO
  561. @endnode
  562. @Node "ConfDBorder"
  563.                            3.5.3 DOUBLE BORDERS
  564.                            ********************
  565. Usually  all  menus of MagicMenu are drawn to appear as if they raise up from
  566. the  display,  while selected items look like they are drawn recessed.  Also,
  567. the  way  the  menu  windows  are  drawn  results  in  the  effect of stacked
  568. index-cards.
  569. Using  this  option  will change that appearance: Only the borders around the
  570. menus  have  the  3d-effect,  selected  menu  items  appear  raised.  As  the
  571. difference  is  only  optical,  try out both kinds to find the one that suits
  572. your personal taste best.
  573. In @{" Standard-Look " Link ConfStandard-Look} this option does not have any effect.
  574. TOOL TYPE:
  575.     DOUBLEBORDER=YES or DOUBLEBORDER=NO
  576. @endnode
  577. @Node "ConfTimeout"
  578.                              3.5.4 MENU TIMEOUT
  579.                              ******************
  580. This function lets you select a timeout, after which a menu selection will be
  581. automatically canceled if no mouse movement or key-presses occur.  Values can
  582. range between one and 120 seconds.
  583. As  MagicMenu  locks  the  screen menus are displayed on (just like Intuition
  584. does), this function will prevent the system from being locked.
  585. Also,  it  may happen occasionally that MagicMenu und Intuition deadlock each
  586. other  (e.g.   when  moving  a window while a menu is to be displayed, though
  587. this  should  not  happen...).   This  deadlock-situation (2 or more programs
  588. waiting for a resource the other programs have already locked) will be broken
  589. up by the timeout of MagicMenu.
  590. See also:
  591.     @{" Possible Problems      " Link Problems}
  592.     @{" Programmer Information " Link Profi}
  593. TOOL TYPE:
  594.     TIMEOUT=<Time in seconds>
  595. @endnode
  596. @Node "ConfHide"
  597.                                  3.5.5 HIDE
  598.                                  **********
  599. This  gadget  closes  the @{" Configuration Window " Link ConfBasic}, MagicMenu will remain acti-
  600. vated. You may also click on the close gadget of the window.
  601. @endnode
  602. @Node "ConfSave"
  603.                                  3.5.6 SAVE
  604.                                  **********
  605. The  current  settings  of  MagicMenu  are  saved  and will be available when
  606. starting MagicMenu again the next time.
  607. MagicMenu  saves all its settings in the icon file from which it was started.
  608. If MagicMenu was started from CLI, an icon file will be created.
  609. @endnode
  610. @Node "ConfQuit"
  611.                                  3.5.7 QUIT
  612.                                  **********
  613. If  this  gadget  is select, MagicMenu will attempt to remove itself from the
  614. system.  This  might  not  succeed.  Check  the  following  chapters for more
  615. information:
  616.     @{" Quitting Magic Menu    " Link Removing}
  617.     @{" Programmer Information " Link Profi}
  618. @endnode
  619. @Node "ConfSmartPatch"
  620.                               3.6.1 SMARTPATCH
  621.                               ****************
  622. Before removing itself from the system, Magic Menu checks all patches vectors
  623. for  other  programs.  If  another  program  has  patched a routine which has
  624. already been patched by Magic Menu, the uninstallation will mostly fail.
  625. There  are some programs which are watching all vectors to help avoiding such
  626. situations.
  627. If  such  a  program is running in your system, Magic Menu would always think
  628. that its patches have been changed.
  629. The  error  message  may  be  ignored  in  this  case, simply click on "force
  630. uninstall".  To  turn  off the security check of Magic Menu set the Tool Type
  631. SMARTPATCH to NO.
  632. TOOL TYPE:
  633.     SMARTPATCH=YES or SMARTPATCH=NO  (Default: YES)
  634. For further information, check the chapter @{" Quitting Magic Menu " Link Profi}.
  635. @endnode
  636. @Node "ConfCheckWB"
  637.                                 3.6.2 CHECKWB
  638.                                 *************
  639. Kickstart  2.04  contains  a  bug  which  causes MagicMenu to recalculate the
  640. workbench   menus   whenever  an icon  is  selected  or  a  window  has  been
  641. (de)activated. This costs cpu time and is completely senseless.
  642. Since KS 3.0 this bug has been fixed by Commodore.
  643. To  make Magic Menu usable with 2.04, a special check is implemented to avoid
  644. unnecassary recalculations of the workbench menus.
  645. This option should always be set to YES, unless there are unexpected problems
  646. with the workbench menus. It has no effects to any other menus.
  647. TOOL TYPE:
  648.     CHECKWB=YES or CHECKWB=NO  (Default: YES)
  649. For further information, check the chapter @{" Programmer Information " Link Profi}.
  650. @endnode
  651. @Node "ConfUseLayer"
  652.                                3.6.3 USELAYER
  653.                                **************
  654. Magic  Menu  renders  all  menus  in  so called "layers", that means that the
  655. system  makes sure that all graphics are clipped into the menu box, even if a
  656. menu is not valid.
  657. But this slows down the rendering of the menus.
  658. Because  of  that,  it  is  possible to turn of this behaviour with this tool
  659. type.  If set to NO, Magic Menu does not use the layers.library to render the
  660. menus.
  661. TOOL TYPE:
  662.     USELAYER=YES or USELAYER=NO  (Default: YES)
  663. @endnode
  664. @Node "ConfKCRAltRCommand"
  665.                             3.6.4 KC_RALTRCOMMAND
  666.                             *********************
  667. Despite  the  keyboard sequence set in the configuration, Magic Menu uses the
  668. right  amiga  key  together  with  the  right  alt  key  to activate the menu
  669. selection, just like the workbench itself.
  670. With this Tool Type you can turn off this feature.
  671. TOOL TYPE:
  672.     KC_RALTRCOMMAND=YES or KC_RALTRCOMMAND=NO  (Default: YES)
  673. @endnode
  674. @Node "ConfCXPrio"
  675.                               3.6.5 CX_PRIORITY
  676.                               *****************
  677. This  option  sets  the  order  in  which all commodities are receiving their
  678. events in the handler chain.
  679. In most cases, it should be set to 0.
  680. TOOL TYPE:
  681.     CX_PRIORITY=<Priorit
  682. t>  (Default: 0)
  683. @endnode
  684. @Node "ConfCXPopUp"
  685.                                3.6.6 CX_POPUP
  686.                                **************
  687. If this  option  is set to YES, Magic Menu pops up its @{" configuration-window " Link ConfBasic}
  688. right after it has been started.
  689. It  should  be  set  to  NO if Magic Menu is always started while booting the
  690. machine (e.g. with the WBStartup drawer)
  691. TOOL TYPE:
  692.     CX_POPUP=YES or CX_POPUP=NO  (Default: YES)
  693. @endnode
  694. @Node "ConfCXPopKey"
  695.                                3.6.7 CX_POPKEY
  696.                                ***************
  697. This  tool  type  sets  the  keyboard  hotkey  to  pop  up  the  Magic Menu's
  698. @{" configuration-window " Link ConfBasic}.
  699. The  default  sequence is "control alt space", but it may be set to any other
  700. valid keyboard sequence.
  701. TOOL TYPE:
  702.     CX_POPKEY=<keyboard sequence>  (Default: control alt space)
  703. @endnode
  704. @Node "ConfDontWait"
  705.                                3.6.8 DONOTWAIT
  706.                                ***************
  707. This  option  MUST  be set if Magic Menu is started from within the WBStartup
  708. drawer, otherwise workbench would wait forever for Magic Menu to complete its
  709. task.
  710. TOOL TYPE:
  711.     DONOTWAIT
  712. @endnode
  713. @Node "ConfToolPri"
  714.                                 3.6.9 TOOLPRI
  715.                                 *************
  716. Workbench  gives  every started process a task priority which can be set with
  717. this Tool Type.
  718. This should be 0 for most programs.
  719. But  Magic Menu should get a higher priority, to avoid cpu consuming programs
  720. from slowing down its display.
  721. A  value  of  5  is  recommended,  as the workbench itself is running at this
  722. priority.
  723. TOOL TYPE:
  724.     TOOLPRI=<Priorit
  725. t>  (Default: 0)
  726. @endnode
  727. @Node "ConfStartPri"
  728.                                3.6.10 STARTPRI
  729.                                ***************
  730. This Tool Type has effect on programs in the WBStartup drawer only.
  731. It  determines  the  order  in  which the programs should be started. In most
  732. cases this should be set to 0.
  733. Programs  which  are modifying the workbench menus (e.g. ToolsDaemon) MUST be
  734. started before Magic Menu.
  735. TOOL TYPE:
  736.     STARTPRI=<Priorit
  737. t>  (Default: 0)
  738. @endnode
  739. @Node "Hotkeys"
  740.                                  4.1 Hotkeys
  741.                                  ***********
  742. Hotkeys are keyboard sequences which always can be used for various actions.
  743. Magic Menu uses the following three hotkeys:
  744.     <CTRL> <ALT> <SPACE>
  745.         Opens  the @{" configuration-window " Link ConfBasic}. This sequence may be modified with
  746.         the CX_POPKEY Tool Type.
  747.     <LEFT AMIGA> <SPACE>
  748.         Activates the  menu selection with the @{" keyboard control " Link ConfKCBasic}. Works only
  749.         with the keyboard control activated. This hotkey may be modified with
  750.         the @{" START SEQUENCE " Link ConfKCStart} option.
  751.         
  752.     <RIGHT ALT> <RIGHT AMIGA>
  753.         Also  activates  the  menu  selection with the keyboard control. This
  754.         hotkey  has  been  implemented  for  compatibility with intuition. It
  755.         cannot  be  modified,  but  may  be  turned  of  with  the  Tool Type
  756.         @{" KC_RALTRCOMMAND " Link ConfKCRAltRCommand}.
  757. @endnode
  758. @Node "CtrlKeys"
  759.                     4.2.1 Keyboard controls for all modes
  760.                     *************************************
  761. The   following   keys   are  always  working  while  a  menu  is  displayed,
  762. irrespective of the current @{" selection mode " Link ConfStandard}:
  763.     <ESC>
  764.         Cancels  the  menu  selection.  In the keyboard control mode only the
  765.         last  submenu  will  be closed. To quit the menu completely it may be
  766.         necessary to press <ESC> up to three times then.
  767.     <CTRL> (while the menu is displayed)
  768.         Switches  the  display between the 3D-Look and the standard intuition
  769.         look.  May  be  used  if  the  colors  of  a  menu  are not displayed
  770.         correctly.
  771.     <CTRL> (press and hold BEFORE activating the menu selection)
  772.         If  any  menu  does  not  work with Magic Menu, it can be temporarily
  773.         deactivated,  and  the  original intuition menus are used instead. Of
  774.         course none of the advanced Magic Menu features can be used then.
  775.     @{" Hotkey " Link Hotkeys} to activate the keyboard control
  776.         If one of both activation hotkeys is pressed, the menu selection will
  777.         be canceled immediately.
  778. For further information, check the chapter @{" keyboard control " Link KCKeys}.
  779. @endnode
  780. @Node "KCKeys"
  781.                            4.2.2 Keyboard control
  782.                            **********************
  783. The  following  keys  are  working  if  the menu is activated with one of the
  784. @{" keyboard hotkeys " Link Hotkeys} only.
  785.     <RETURN>
  786.         Opens  a  (sub)menu  or selects a menu item. If pressed together with
  787.         the  shift key more than one item can be selected. The last item must
  788.         be selected without pressing the shift key.
  789.     <CURSOR RIGHT> and <CURSOR LEFT>
  790.         Selects  one  of  the  main  menu items. If pressed together with the
  791.         shift key the box it moved to the right or leftmost item.
  792.     <CURSOR UP> and <CURSOR DOWN>
  793.         Selects  a (sub)menu item. If pressed together with the shift key the
  794.         box is moved to the top or bottom item.
  795.     Alphanumeric key
  796.         The  next (sub)menu item starting with the corresponding character is
  797.         selected.  If this item is the only one starting with this letter, it
  798.         will be activated, too.
  799.         
  800. For further information, check the chapter @{" keyboard controls " Link ConfKCBasic}.
  801. @endnode
  802. @Node "Questions"
  803.                             5.1 Question & Answer
  804.                             *********************
  805. F:  "If I activate the menu, everything freezes. Why?"
  806. A:  Magic Menu has to lock the screen on which the menu is  displayed. Just
  807.     like  intuition  itself.  That  means  no program is allowed to make an
  808.     output  to  that  screen.  All  other  screens  are not locked with one
  809.     exception:  windows  cannot  be  opened.  Programs  that want to open a
  810.     window have to wait until the menu selection has been finished.
  811. F:  "My  program  is  running  on  another  screen,  but nevertheless it is
  812.     stopped. Why?"
  813. A:  Does the programs  make any outputs  to a CLI  (which is located on the
  814.     workbench in most cases)? This happens without magic menu, too. Another
  815.     possibility  is that the program  tries to open a window while the menu
  816.     is displayed.
  817. F:  "The menus of some programs have really strange colors. Why?"
  818. A:  If  a screen is opened with the 2.0 "tags" then it is supplied with the 
  819.     correct  color  table.  On all other screens (which are opened in a 1.3
  820.     compatible  way) Magic Menu uses the standard display (like intuition).
  821.     Programs like "TagScreens" promote these old screens to the new 3D-Look
  822.     ones,  but  sometimes  the colors are not quite correct. You may always
  823.     switch  to the standard display with the CTRL key, if the menus are not
  824.     usable.
  825. F:  "In  color  selection  menus   some  of  the  colors  are not displayed
  826.     correctly."
  827. A:  Press the CTRL key while the menu is displayed.
  828. References:
  829.     @{" Known Problems of MagicMenu " Link Problems}
  830.     @{" Programmer Information " Link Profi}
  831. @endnode
  832. @Node "Problems"
  833.                       5.2 Known Problems of Magic Menu
  834.                       ********************************
  835. Some problems are unavoidable. This is a list of all known problem, so nobody
  836. should be surprised by them:
  837.   o  On  all  window  operations  except    OpenWindow(), OpenWindowTagList()
  838.      and  ActivateWindow()  it  is possible to create a deadlock situation if
  839.      the  menu  is  displayed.  This  deadlock  will  always  be ended by the
  840.      timeout.
  841.   o  To  display  the menus  in the  OS 2.0 3D-Look,  the text and background
  842.      pen are  reversed. I tried to implement this as intelligent as possible,
  843.      but there may be some menus with wrong colors.
  844. References:
  845.     @{" Question & Answer " Link Questions}
  846.     @{" Programmer Information " Link Profi}
  847. @endnode
  848. @Node "Profi"
  849.                         5.3 Programmer's information
  850.                         ****************************
  851. I've  tried  to make Magic Menu as compatible as possible, that means that it
  852. behaves just like intuition wherever possible.
  853.   o  While  displaying a menu the corresponding screen is locked. The menu is
  854.      rendered  in  the  background  and  is  copied into the screen using the
  855.      layers.library routine SwapBitsRastPortClipRect().
  856.   o  To  avoid  crashing  memory  as  a result of a bug or an illegally built
  857.      menu, all drawing operations are clipped using the layers library.
  858.   o  Before displaying a menu, Magic Menu sends a message to all windows with
  859.      the  IDCMP_MENUVERIFY  flag  set.  The active window may cancel the menu
  860.      selection by replying the message with MENUCANCEL.
  861.   o  Magic Menu  sends  menu events  through the  input.device  handler chain
  862.      using  the  IND_WRITEEVENT  command.  Intuition  dispatches a respective
  863.      message  to the active window. Even programs that are receiving the menu
  864.      selection via the console.device are supported.
  865.      
  866.   o  IDCMP_MENUHELP is supported.
  867.   o  The  functions   OpenWindow(),   OpenWindowTagList(),  ClearMenuStrip(),
  868.      SetMenuStrip(),  ResetMenuStrip()  and ActivateWindow() are patched. All
  869.      calls  to these routines are suspended until any menu selection has been
  870.      finished to avoid deadlocks.
  871. References:
  872.     @{" Question & Answer " Link Questions}
  873.     @{" Known problems of Magic Menu " Link Problems}
  874. @endnode
  875. @Node "History"
  876.                                  6.1 History
  877.                                  ***********
  878. To  learn  about  the  changes of the many releases of Magic Menu, you should
  879. read the following chapter.
  880. Maybe  you simply want to read something about the problems I had to solve to
  881. get the whole thing working.
  882. The  english version of the release history is very short, I'm afraid. You'll
  883. have to read the german version, to get further information.
  884.                                @{" Version 1.29 " Link Hist129}
  885.                                @{" Version 1.27 " Link Hist127}
  886.                                @{" Version 1.22 " Link Hist122}
  887.                      @{" Planned features for future releases " Link Future}
  888. @endnode
  889. @Node "Hist129"
  890. Revision V1.29
  891. --------------
  892. changed on Tuesday, 23-Nov-93  22:33:00
  893.     Following bugs are fixed:
  894.     - The field ie_Qualifier of all messages and events created by
  895.       MagicMenu was unset (= 0). Now the field is initialized with the
  896.       value returned by PeekQualifier() of the input.device. After this
  897.       fix every program that interprets this field with menu events should
  898.       work now (e.g. ADoc, GenAm) (Reported by Denis Gounelle)
  899. Revision V1.28
  900. --------------
  901. changed on Wednesday, 06-Okt-93  23:24:00  by  --- Unknown ---.   LogMessage :
  902.     Following bugs are fixed:
  903.     - Special bug-fix for Mr. SIERRA@FUTURE.zer.sub.org!
  904.       The multual exclude field is now checked with 32 bits instead
  905.       of 16 bits.
  906. @endnode
  907. @Node "Hist127"
  908. Revision V1.27
  909. --------------
  910. changed on Sunday, 01-Aug-93  16:27:00  by  --- Unknown ---.   LogMessage :
  911.     Following bugs are fixed:
  912.     - The shifting of the menus introduced in V 1.26 has been removed
  913.       again, because of trouble with the look of some menus. Instead,
  914.       Magic Menu uses smaller images if the standard ones don't fit.
  915.     - On some programs using their own checkimage it could happen that
  916.       some pixels of the menuitem were erased.
  917. Revision V1.26
  918. --------------
  919. changed on Saturday, 31-Jul-93  20:45:00  by  Martin Kornd
  920. rfer.   LogMessage :
  921.     Following bugs are fixed:
  922.     - Menu items with 0x0 pixels could crash MagicMenu. This was the
  923.       reason for the DOpus 4.1x crash. BTW, such menu items are NOT
  924.       valid!
  925.     - A mx menu item may now have the flag MENUTOGGLE set.
  926.     - MM could not display menus exceeding the right edge of the screen.
  927.       This has been fixed, now Term 3.4 has its "Dial" menu back.
  928.     - The checkmark is rendered AFTER the texts again. There was trouble
  929.       with some menus overwriting the checkmarks otherwise.
  930.     - With KS 3.x some menu texts were to close to the checkmark image,
  931.       because the system now scales the images. MM now shifts all texts
  932.       if necessary to get enough room for its images.
  933. Revision V1.25
  934. --------------
  935. changed on Thursday, 24-Jul-93  19:51:00  by  Martin Kornd
  936. rfer.   LogMessage :
  937.     Following bugs are fixed:
  938.     - In release 1.24, windows WITHOUT the NewLookMenu flag were not
  939.       been recognized properly.
  940.     Additions:
  941.     - WindowToFront() is patched now, too. Now there should be no
  942.       problem with programs which pop a window to the front.
  943.     - After completing a keyboard selection, the mouse is moved to its
  944.       previous position. (Suggestion by Garry Glendown).
  945.     - New Tool Types:
  946.       o USELAYER (Default: YES):
  947.          if set to YES, Magic Menu uses the layers.library to avoid
  948.          trashing memory as a result of improper menus or a bug in
  949.          Magic Menu itself. If you set this Tool Type to NO, the rendering
  950.          of all menus will be about 25% faster.
  951.       o KC_RALTRCOMMAND (Default: YES):
  952.          To disable the keyboard sequence "rcommand ralt" for the
  953.          keyboard menu selection, set this option to NO.
  954. Revision V1.24
  955. --------------
  956. changed on Thursday, 22-Jul-93  22:50:00  by  Martin Kornd
  957. rfer.   LogMessage :
  958.     Following bugs are fixed:
  959.     - Some programs try to implement a 3.0-ish look for their menus
  960.       manually. This has caused some problems with Magic Menu.
  961.       (Reported by Garry Glendown)
  962. Revision V1.23
  963. --------------
  964. changed on Tuesday, 18-Mai-93  22:09:51  by  Martin Kornd
  965. rfer.   LogMessage :
  966.     Following bugs are fixed:
  967.     - In standard look, some menu items have been deleted while playing with
  968.       the menu.
  969.     - The checkmark has been overwritten on some menus.
  970. @endnode
  971. @Node "Hist122"
  972. Revision V1.22
  973. --------------
  974. changed on Wednesday, 24-Feb-93  13:42:39  by  Martin Kornd
  975. rfer.   LogMessage :
  976.     Following bugs are fixed:
  977.     - The checkmarks were not been updated correctly while selecting more
  978.       items in the standard-look.
  979.     Changes:
  980.     - If CHECKWB is set to YES, a similar patch is made for PageStream.
  981.       (Requested by Martin Huttenloher)
  982. Revision V1.21
  983. --------------
  984. changed on Tuesday, 16-Feb-93  18:00:21  by  Martin Kornd
  985. rfer.   LogMessage :
  986.     Following bugs are fixed:
  987.     - If the right mouse button was pressed on a menu-less window, some
  988.       memory got lost. (Reported from Paul Miranda and Peter Elzner).
  989.     - With the RMBTRAP flag set, Magic Menu generated two MENUDOWN messages.
  990.     - The font for the menu strip was not always correct.
  991.     - MagicMenu now handles requesters (and double-menu requesters, too)
  992.       correctly. (Reported by Gerhard Schmidt).
  993.     - Two enforcer hits removed.
  994.     Changes:
  995.     - Virtual screens are now moved to get the menu always visible while
  996.       selecting with the keyboard.
  997. @endnode
  998. @Node "Future"
  999.                             6.2 Planned features
  1000.                             ********************
  1001. Following features are planned for comming releases of Magic Menu:
  1002.   o  Detached menus
  1003.   o  Extra settings for every screen
  1004.   o  A completly rewritten user interface with more options
  1005.   o  Localisation
  1006.   o  Extra configuration program
  1007.   Suggestions are welcome!
  1008. @endnode
  1009. @Node "Credits"
  1010.                                  7.1 Credits
  1011.                                  ***********
  1012. Magic Menu is written by
  1013.    Martin Kornd
  1014.    Pommernstr. 15
  1015.    D-86916 Kaufering
  1016.    E-Mail addresses:  Internet: korndorf@informatik.tu-muenchen.de
  1017.                       Z-Netz  : M.KORNDOERFER@NATHAN.ZER or
  1018.                                 SYSOP@NATHAN.ZER
  1019.    Phone: +49 8191 6383
  1020. This english documentation has been written by
  1021.    Garry Glendown
  1022.    Martin Kornd
  1023.    additional work and corrections by Martin Huttenloher
  1024.       Thank you very much for your great work, Martin & Garry!
  1025. The user interface has been build with
  1026.     GadToolsBox 1.4 by Jan van den Baard
  1027.     ... thanx for this wonderful program!!
  1028. Magic Menu has been developed with the
  1029.     SAS/C 5.10b / 6.0 - 6.3 C-Compilers
  1030. The icon has been created by
  1031.     Martin Huttenloher
  1032. The first, really buggy versions have been tested by
  1033.     Angelika Nadler
  1034.     Olaf Lange
  1035.     Thomas Starke
  1036.     Quinten Martens
  1037.     Markus Bartsch
  1038.     Martin Neuhauser
  1039.     Dirk Taggesell
  1040. For their suggestions and bugreports I'd like to thank (in alphabetical 
  1041. order):
  1042.    Markus Bartsch, Candid B
  1043. schen, S
  1044. nke Brandt, Reza Elghazi, Kay Gehrke,
  1045.      Garry Glendown, Toni G
  1046. nzel-Peltner, Marc Heuler, Michael Hohmann,
  1047.         Martin Huttenloher, Marc Jackish, Thomas Mainz, Hans Maurer,
  1048.     Matthias M
  1049. rstedt, Ralph Sch
  1050. fer, Andreas Schildbach, Stefan Stuntz,
  1051.                Dirk Taggesell, Christoph Teuber, Michael Thiel
  1052.   and all the others ...
  1053. Further thanx should go to...
  1054.     Kai Iske        ... for his KCommodity
  1055.     Stefan Stuntz   ... for his MFR and the idea for the name ... ;-)
  1056.     Garry Glendown  ... for his tips about SAS/C and the patching
  1057.     Angel
  1058.     ... you're simply magic!
  1059. @endnode
  1060. @Node "Licence"
  1061.                                7.2 DISCLAIMER
  1062.                                **************
  1063.                              No Warranty
  1064.                              -----------
  1065.    THERE  IS  NO  WARRANTY  FOR  THE  PROGRAM,  TO  THE EXTENT PERMITTED BY
  1066.    APPLICABLE  LAW.   EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  1067.    HOLDER  AND/OR  OTHER  PARTIES  PROVIDE  THE  PROGRAM  "AS  IS"  WITHOUT
  1068.    WARRANTY  OF  ANY  KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  1069.    LIMITED  TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  1070.    PARTICULAR  PURPOSE.   THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE
  1071.    OF  THE  PROGRAM  IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE,  YOU
  1072.    ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  1073.    IN  NO  EVENT  UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  1074.    WILL  ANY  COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  1075.    PROGRAM  AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  1076.    GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  1077.    USE  OR INABILITY TO USE THE PROGRAM  (INCLUDING BUT NOT LIMITED TO LOSS
  1078.    OF  DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  1079.    THIRD  PARTIES  OR  A  FAILURE  OF THE PROGRAM TO OPERATE WITH ANY OTHER
  1080.    PROGRAMS),  EVEN  IF  SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  1081.    POSSIBILITY OF SUCH DAMAGES.
  1082. Magic Menu 
  1083.  1992/93 Martin Kornd
  1084. Magic Menu is *NOT* in the Public Domain!
  1085. It may be distributed only if the following files are included:
  1086.     MagicMenu
  1087.     MagicMenu.info
  1088.     Deutsch/MagicMenu.guide
  1089.     Deutsch/MagicMenu.guide.info
  1090.     Deutsch/Benchmark
  1091.     Deutsch/Benchmark.info
  1092.     Deutsch/History
  1093.     Deutsch/History.info
  1094.     English/MagicMenu.guide
  1095.     English/MagicMenu.guide.info
  1096.     English/Benchmark
  1097.     English/Benchmark.info
  1098.     English/History
  1099.     English/History.info
  1100. As  long  none  of  the  above  files  is missing, Magic Menu may be freely
  1101. distributed on disk or on any network. A disk containing Magic Menu may not
  1102. be sold for more than 5$ or an equivalent value. 
  1103. @endnode
  1104.